…mmands

… fields

- Add intent methods (TurnOn/TurnOff/Toggle/SetBrightness/SetColor/SetEffect/SetPalette/Reboot)
- Add CancellationToken to every client method
- Add typed exception hierarchy (WledException + connection/response/version)
- Add HttpClient constructor and Kevsoft.WLED.DependencyInjection AddWledClient
- Add intent, exception and DI tests

… sample

- Rewrite README around intent methods, fluent builders, DI and error handling
- Add a supported-features capability matrix and document target frameworks
- Add CHANGELOG.md (Keep a Changelog format)
- Rewrite BasicConsole sample to showcase the ergonomic API

…35 range

…rom~tor')

…cked escape hatch

Model the state 'seg' field as a union (SegmentPayload) that serializes as either
an object (selected segments) or an array (id-targeted), matching the WLED API.
No-id SetColor/SetEffect/SetPalette now emit the object form instead of an array
that WLED would infer as id:0.

Model id.mdns, if.mqtt (en/broker/port/user/cid) and def (on/bri/ps) as typed
properties while keeping JsonExtensionData as an escape hatch for everything else.

Add root AGENTS.md with project conventions, commands and gotchas.
Add EffectCatalog/PaletteCatalog with id/name lookup, reserved-entry
filtering (RSVD/-), and SetEffect/SetPalette catalog-entry overloads.

StateUpdate.SelectedSegments(...) targets the selected segments via the
seg object form and accumulates across calls. Mixing it with Segment(id, ...)
in one update throws, since WLED's seg field is one form or the other.

GetDevice() issues a single GET /json and exposes state, info and typed
effect/palette catalogs as one snapshot, with per-segment effect/palette
resolution and derived helpers (SelectedSegments, ActiveSegments,
SupportsWhiteChannel, etc). Effect metadata is opt-in to avoid extra requests.

Add lookup helpers (FindById/FindByName/Try*) over effect metadata
collections, plus SegmentUpdate.Effect(EffectMetadata) and
ApplyEffectDefaults(EffectMetadata) to set speed/intensity/custom sliders
from metadata defaults (c3 clamped to 0-31).

Introduce SegmentId, EffectId, PaletteId, PresetId, PlaylistId,
LedMapId, SegmentBounds and MatrixBounds readonly structs with range
validation, equality and netstandard2.0-safe hashing. Wire SegmentBounds
and MatrixBounds into SegmentUpdate.Range/Range2D and LedMapId into
StateUpdate.LoadLedMap as non-ambiguous overloads.

Introduce ConfigUpdate and an UpdateConfig(Action<ConfigUpdate>) client
overload exposing Identity, Mqtt and BootDefaults helpers. Only touched
sections and fields are serialised, reusing the existing network opt-in
guard.

Add README sections and feature-matrix rows for the device snapshot,
catalogs, selected-segment updates, strong value types and the fluent
config builder; expand the CHANGELOG and BasicConsole sample to match.